export interface Article {
  /** 文章ID，主键，自增 */
  id: string;

  /** 文章标题 */
  title: string;

  /** 文章摘要 */
  summary: string;

  /** 文章作者 */
  author: string;

  /** 文章分类id */
  category: string;

  /** 文章分类别名 */
  categorySlug: string;

  /** 文章分类名称 */
  categoryName: string;

  /** 文章封面图片URL */
  coverImage: string;

  /** 文章别名（用于URL） **/
  slug: string;

  /** 文章标签，多个标签用逗号分隔 */
  tags: string[];

  /** 文章发布时间 */
  publishTime: string;

  /** 文章来源（0: 原创, 1: 转载） */
  source: number;

  /** 是否置顶（0: 否, 1: 是） */
  isSticky: number;

  /** 文章热度值 */
  hotness: number;

  /** 文章浏览次数 */
  views: number;

  /** 文章点赞次数 */
  likes: number;

  /** 文章评论次数 */
  commentsCount: number;
}

/** 自动补全建议项 */
export interface AutocompleteSuggestion {
  /** 建议文本 */
  text: string;
  /** 相关性评分 */
  score: number;
  /** 文章ID */
  articleId: number;
  /** 分类名称 */
  categoryName: string;
  /** 别名 */
  slug: string;
  /** 建议类型 */
  type: 'title' | 'summary';
  /** 高亮文本 */
  highlightText: string;
}

/** 自动补全响应数据 */
export interface AutocompleteResponse {
  /** 标题建议 */
  titleSuggestions: AutocompleteSuggestion[];
  /** 摘要建议 */
  summarySuggestions: AutocompleteSuggestion[];
  /** 所有建议（按评分排序） */
  allSuggestions: AutocompleteSuggestion[];
}

/** 自动补全请求参数 */
export interface AutocompleteParams {
  /** 搜索关键词 */
  keyword: string;
  /** 分类名称（可选） */
  categoryName?: string;
  /** 返回数量（可选，默认10，最大20） */
  size?: number;
  /** 补全类型（可选） */
  type?: 'title' | 'summary' | 'all';
}
